<HTML><HEAD><TITLE>lp_get_license(+LicStr, +LicNum)</TITLE>
</HEAD><BODY>[ <A HREF="index.html">library(eplex)</A> | <A HREF="../../index.html">Reference Manual</A> | <A HREF="../../fullindex.html">Alphabetic Index</A> ]
<H1>lp_get_license(+LicStr, +LicNum)</H1>
Get a runtime license token for the external solver.
<DL>
<DT><EM>LicStr</EM></DT>
<DD>String or Atom
</DD>
<DT><EM>LicNum</EM></DT>
<DD>Integer
</DD>
</DL>
<H2>Description</H2>
    	The eplex-library interfaces to an external simplex/MIP solver
	which might require a license to run (e.g. CPLEX, XPRESS-MP).
	When the eplex-library is loaded, it tries to obtain a license
	immediately.  However, this might not be possible, either
	because no licenses are currently available, or because
	specific licensing information needs to be supplied.
    <P>
	In the latter case, lp_get_license/2 must be called explicitly
	by the programmer, and the relevant licensing information must
	be supplied as arguments.  The meaning of the arguments is
	specific to the solver used:
    <PRE>
                                LicStr          LicNum

        CPLEX development       unused          unused
        CPLEX runtime           licenvstring    serialnum
        XPRESS-MP development   xpress_path     unused
        XPRESS-MP runtime       xpress_path     response
        OSI                     unused          unused
    </PRE>
        If LicStr is a file or directory name, it is expected to be in
	the native operating system syntax.
    
<H3>Fail Conditions</H3>
Fails if no license can (currently) be obtained
<H2>See Also</H2>
<A HREF="../../lib/eplex/lp_get_license-0.html">lp_get_license / 0</A>, <A HREF="../../lib/eplex/lp_release_license-0.html">lp_release_license / 0</A>, <A HREF="../../lib/eplex/lp_get_license_challenge-1.html">lp_get_license_challenge / 1</A>
</BODY></HTML>
